home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 26
/
Cream of the Crop 26.iso
/
bbs
/
txmail21.zip
/
TXMAILER.DOC
< prev
next >
Wrap
Text File
|
1997-05-17
|
17KB
|
351 lines
▄▄ ▄▄
▀▀▀▀█▀▀▀▀ █▀▀▀▀▀▀▄ ▄▀▀▀▀▀▀▄ █▄ █ █▀▀▀▀▀▀ ▀█▄ ▄█▀
█ █▀▀▀▀▀▀▄ █▀▀▀▀▀▀█ █ ▀▀▄▄ █ ▀▀▀▀▀▀█ ▐█▌
█ █ █ █ █ █ ▀█ ▄▄▄▄▄▄█ ▄█▀ ▀█▄
▄█▀ ▀▀
▄█▀ Mailer
Internet/Fidonet Transporter ▄█▀
Copyrighted Multiboard Communications Centre, 1995-1997
All rights reserved ▄█▀
▄█▀
╓────────────────────────────────────────────────────────────────────────────╖
║ Introduction ║
╙────────────────────────────────────────────────────────────────────────────╜
What is it?
■ TxMAILER is a package that will use SMTP and POP3 to send and
retrieve TransX mail bundles from your standard email account.
■ TxMAILER is only designed to be used with TransX v1.1 or higher
and does not function as a stand-alone package.
How does it work?
■ What it does is dial your Internet provider over a PPP link and
once connected sends your outbound TransX bundles with SMTP
then scans your POP3 mailbox for any TransX mail. If it finds
any, it will save them to disk for TransX to process and remove
them from your mailbox.
■ If you normally use this same mailbox for your personal mail and
download it with something like Eudora(r), Microsoft Exchange(r)
or Microsoft Mail/News(r) you will need to take precaution to make
sure that mail for TransX is not deleted from your mailbox when you
transfer mail from your host to your machine. Some of the readers
mentioned above will allow you to specify whether mail should
automatically be deleted from your mailbox. If not you must always
run TxMAILER before downloading your mail otherwise your regular
mail client will download all the mail and delete it from the
mailbox, including the TransX mail rendering TxMAILER useless.
■ An optimal solution would be to ask your Internet provider if you
can have a secondary mailbox. Most providers will do this for
free or for a very nominal charge. Get your second mailbox named
something like "userid-tx", in my case "rocca-tx" this would
become your robot name in TransX, as well as your mailbox name.
Then all of the TransX mail could be sent and received from
"userid-tx@yourisp.com" leaving your personal mailbox untouched
by TransX or TxMAILER.
How much work is it to run and maintain?
■ Once setup, this send and receive transfer process is fully
automated and runs from a batch file which is automatically
created each time you run TXBUILD.EXE
╓───────────────────────────────────────────────────────────────────────────╖
║ Installing ║
╙───────────────────────────────────────────────────────────────────────────╜
Installing TxMAILER couldn't be simpler.
1) Simply extract the archived package into the SAME directory
you have TransX installed into. (if you have not yet installed
TransX you will need to before installing TxMAILER)
2) Run TXSETUP.EXE (from your original TransX installation)
Configure TransX to use SMTP as the Advanced Spool Type.
Also specify the SMTP In and Out directories.
┌──┤ Advanced Options ├──────────────────────────┐
│ │
│ Advanced spool │
│ └ Type : SMTP (In/Out) │
│ │
│ SMTP options │
│ ├ SMTP In : M:\TRANSX\SMTP\IN\ │
│ ├ SMTP Out : M:\TRANSX\SMTP\OUT\ │
│ └ Time zone: -0500 │
│ │
└────────────────────────────────────────────────┘
Please note that the In and Out directories MUST be different
from each other, otherwise you will lose mail packets.
You'll also need to configure your General Information to
reflect your PPP setup.
┌──┤ General Information ├─────────────────────────┐
│ │
│ Sysop : Joe User (a) │
│ System name : Joe's BBS System (b) │
│ Domain : yourisp.com (c) │
│ Site address : 1:999/9238 (d) │
│ Gate address : 0:0/0 (e) │
│ Gate netflags : Kill/Direct (f) │
│ Robot name : transx (g) │
│ │
└──────────────────────────────────────────────────┘
(a) Your name
(b) Your BBS name
(c) Your providers domain name
(d) Your main Fidonet style address
(e) 0:0/0
(f) Kill/Direct
(g) Your mailbox name (usually)
For example if your email address is fred@site.com
then "fred" would be your robot name and "site.com"
would be your domain.
3) Edit the LOGIN.CMD script file to log you on your Internet
provider. The commands that are available are as follows:
START - The script begins with this line
DEBUG ON - You can turn on display debugging
HANGUP - Attempt to hangup
SEND <string> - Sends the 'string' to the modem
SEND - Sends a CR/LF to the modem
WAIT <time> <string> - Waits up to 'time' seconds for 'string'
WAIT <time> - Waits 'time' seconds
PRINT <string> - Displays 'string' to the console
END - Signal that the script was successful
There is a sample LOGIN.CMD file included.
4) Run TXBUILD.EXE, and fill in the required information. There is
also online help available by pressing "F1". Each time this program
exits, it will create/update the TXFULL.BAT file which is what you
will need to run in order to handle all of the processing.
╓───────────────────────────────────────────────────────────────────────────╖
║ Running ║
╙───────────────────────────────────────────────────────────────────────────╜
Now you just run TXFULL.BAT to transfer your mail whenever needed.
This batch file will:
* Make sure that all the required files exist
* Make sure that all the drivers are loaded
* Export your TransX mail
* Dial your Internet provider
* Transfer the mail
* Unload the installed drivers
* Hang up
* Import any TransX mail received
╓────────────────────────────────────────────────────────────────────────────╖
║ Common Questions and Answers ║
╙────────────────────────────────────────────────────────────────────────────╜
First of all, thanks for reading this section!
Q) The mail gets downloaded from my provider ok, and I see it sitting
in the inbound SMTP directory I have defined, but TransX just
ignores it?
A) This is often caused by having the incorrect domain address for
your provider. Many providers have their 'root' domain, for
example "site.com", but email addresses are on another domain
for example "galaxy.site.com". You can find out for sure by
turning on DEBUG logging in TXSETUP, then when you run TransX
you should see something like:
= Opening at 15 Jun 96 09:50:38
& 0 routing entries
& Skip; to userid-tx@storm.site.com (SMTP), from ...
= Closing at 15 Jun 96 09:50:38
In this case, the domain name is "storm.site.com", and the
robot name should be "userid-tx"
In addition if your robot name in TXSETUP does not match the one
being sent to then your mail will also not be imported.
Q) I can only get one mailbox from my provider, will TxMAILER
delete my non-TransX mail?
A) TransX will only download mail that has "Receipt" or "Transport"
as the subject line. There is a chance that other mail could
have these subject lines. If this is a heavy concern, you should
seek out another provider who can offer you a second mailbox.
Q) It's not initializing my modem?
A) Try reducing the baud rate to 38400.
Q) It crashes my machine when hanging up?
A) Try using the fossil driver support.
Q) TxMAILER says it can't resolve <name>?
A) Make sure that your Gateway, Netmask and Name Server entries
are correct in TxBUILD. If you are unsure of what the values
should be, then please contact your Internet provider for the
correct addresses. If that still does not work trying changing
the Netmask value in TxBUILD to 0.0.0.0
Q) I keep getting an error message saying <something> but can't
get past it?
A) Please send us a copy of your log file and the TXDEBUG.LOG and
we will try to get it solved as quickly as possible.
Q) It says that my POP3 username/password is invalid but I know it's
the right password.
A) Make sure that you have not included the domain name after the
POP3 account name. For example with user@yoursite.com your POP3
name would probably be "user" not "user@yoursite.com"
╓───────────────────────────────────────────────────────────────────────────╖
║ Support ║
╙───────────────────────────────────────────────────────────────────────────╜
If you have any questions or comments, you can netmail us at FidoNet
address 1:2401/305 (CM,V34,VFC). Please poll back for your replies
as we get dozens of messages a day or optionally make a note that you
would like your message routed back to you. You can also contact us
via the Internet for faster responses, and directly sent out replies.
The address is "support@multiboard.com" Also please look at our
TxMailer tech support site at http://www.multiboard.com/txhelp.html
You can also find us in the RA_UTIL echo conference, as well as the
MCC_SUPPORT echo of course.
The newest MCC software is also available via the Internet:
http://www.multiboard.com/
ftp://ftp.multiboard.com/
You can also "FREQ" the files from us via FidoNet at 1:2401/305
Our system is online and taking requests 24 hours/day
The magic name for the newest version of TransX is "TRANSX"
The magic name for the newest version of TxMAILER is "TXMAILER"
Freq "CATALOG" for the newest list of our other products.
You can help us direct your messages by using the alternative email
addresses when posting us mail:
(1) support@multiboard.com - general inquiries
(2) sales@multiboard.com - registrations/commercial info
(3) suggestions@multiboard.com - suggestions
(4) reports@multiboard.com - bug reports
Thanks for your interest and support!
╓───────────────────────────────────────────────────────────────────────────╖
║ Changes ║
╙───────────────────────────────────────────────────────────────────────────╜
v1.0 - First release
v1.1 - Made some small changes to the dialing package
- Fixed a bug that would cause it to not be able to
detect the IP address in SLIP mode if your provider
used a particular type of IP notification message
- Fixed a bug that could cause a lockup while trying to
send the encoded messages
v1.2 - Puts the TXMAILER.LOG file in the same directory as
you have specified for the TX.LOG file.
- If your IP address in TxBUILD is not set to 0.0.0.0 it
no longer tries to find a dynamic IP address
- If there is a file called BETWEEN.BAT in the current directory
then TxMAILER will run it (memory permitting) after checking
the POP3 mailbox. When it returns it will send any new mail
waiting to go out. The purpose of this is to allow you to
call up, receive new mail, run TransX while still online and
send out any receipts you may have created for the mail you
just received.
- Added a command line parameter /NUKEALL, this will remove
all mail from your mailbox, TransX or not. Any mail not
to TransX will be saved as nnn.@@@ in your inbound SMTP
directory. Use with caution.
v1.3 - Recognizes the x.x.x.x. (with trailing period or comma)
as a valid IP number.
- Accepts a 220 response to a HELO command (the SMTP host
did not accept our handshake error message)
- Fixes the omission of the GOTO :END label in the batch file
- Allows for an /IP=x.x.x.x on the command line to set IP
╓───────────────────────────────────────────────────────────────────────────╖
║ License and Disclaimer ║
╙───────────────────────────────────────────────────────────────────────────╜
TxMAILER is FREE, provided you have registered or bought a commercial
copy of "TransX". If you are using the unregistered shareware version
of TransX, then you have fourteen (14) days to evaluate TxMAILER.
TransX is being marketed under the "try before you buy" or the shareware
concept. You are entitled to use TransX for a period up to thirty (30)
days, after which you MUST register or stop using the program.
Registration will also you to use all of the available functions of
TransX, and help to continue the development of this program. (not
to mention maintain the legality of this agreement)
By running any of the executable programs included, you agree that
Pete Rocca, Darryl Olthoff, Multiboard Communications Centre nor any
affiliates of the above mentioned are responsible for any damage or
loss experienced, however so created. If you cannot agree to this,
then your privilege to use any of these programs is revoked and it
becomes illegal for you to execute any programs included with this
documentation.
You may freely copy and distribute the shareware version of TransX as
long as its original archived contents are not modified in any way.
You may NOT distribute any registration keys without the expressed
written consent of Pete Rocca of Multiboard Communications Centre.
You may not use a registration key that is not licensed to you by
Pete Rocca, or any of the registration sites appointed by Pete Rocca.
It is illegal to edit, alter, hack, reverse engineer and / or modify
any components of TransX or its archive components in any manner.
TransX and its encoding and security algorithms are the legal
property of Multiboard Communications Centre. They may not be used
in any other program other than TransX without the express written
consent of Pete Rocca of Multiboard Communications Centre.
This product, concept and design are protected by Canadian copyright
laws and international treaty provisions. If dispute of any issues
on legal grounds said above, then governing law of Ontario, Canada
will rule. If you agree to all of the above, then you may use
these programs.
* REMEMBER THAT REGISTRATION IS QUITE INEXPENSIVE FOR ALL YOU SAVE *
The TCP/IP stack of this product was developed with the WATTCP TCP/IP
library routines copyright (c) 1990-1993 Erick Engelke. The TxMAILER
package is also bundled with the PPPD packet driver courtesy of
and copyrighted by Antonio Lopez Molero.
Eudora(r), Microsoft Mail/News(r) and Microsoft Exchange(r) are owned,
copyrighted and/or trademarked by their respective companies.